Save Method
The Save method saves the window contents of an IDL Graphic to an image file.
Example
The following code sample creates a bar plot and saves the image to a PNG file.
x = FINDGEN(41)/10 - 2
gauss = EXP(-x^2)
myPlot = BARPLOT(x, gauss, TITLE='Gaussian Distribution', $
XTITLE='$\it x$', YTITLE='$\it f(x)$', YRANGE=[0,1.1])
myText = TEXT(0.75,0.85,'$\it f(x)=exp(-x^2)$', /DATA, FONT_SIZE=24)
myPlot.Save, "gaussian.png", BORDER=10, RESOLUTION=300, /TRANSPARENT
Additional Examples
See Additional Examples for more code examples using the Save method.
Syntax
graphic.Save, Filename, /ANTIALIAS, /APPEND, BIT_DEPTH={0|1|2}, /BITMAP, BORDER=integer, /CENTIMETERS, /CLOSE, /CMYK, COMPRESSION={0|1|2}, HEIGHT=integer, LANDSCAPE, /MEMORY, PAGE_SIZE=value, RESOLUTION=integer, /REVERSIBLE, TRANSPARENT=array, WIDTH=integer, XMARGIN=integer, YMARGIN=integer
Arguments
Filename
A string containing the full pathname of the file to which the graphic should be written.
The file format of the saved file is determined from the Filename file suffix. For example, if Filename is image.bmp, the file is saved in bitmap format.
The supported file formats are listed in the following table:
|
File Suffix |
File Format |
Allowed Keywords |
|---|---|---|
|
BMP |
Windows bitmap |
ANTIALIAS, BORDER, TRANSPARENT, RESOLUTION, WIDTH, HEIGHT |
|
EMF |
Windows enhanced metafile |
BITMAP, RESOLUTION, WIDTH, HEIGHT |
|
EPS, PS |
Encapsulated PostScript |
BITMAP, CMYK, RESOLUTION, WIDTH, HEIGHT |
|
GIF |
GIF image |
ANTIALIAS, APPEND, BORDER, CLOSE, RESOLUTION, WIDTH, HEIGHT |
|
JPG, JPEG |
JPEG image |
ANTIALIAS, BORDER, RESOLUTION, WIDTH, HEIGHT |
|
JP2, JPX, J2K |
JPEG2000 image |
ANTIALIAS, BORDER, REVERSIBLE, RESOLUTION, WIDTH, HEIGHT |
|
KML |
OGC Keyhole Markup Language |
|
|
KMZ |
A compressed and zipped version of KML. |
|
|
|
Portable document format |
APPEND, BITMAP, CENTIMETERS, CLOSE, LANDSCAPE, MEMORY, PAGE_SIZE, XMARGIN, YMARGIN, RESOLUTION, WIDTH, HEIGHT |
|
PICT |
Mac PICT image |
ANTIALIAS, BIT_DEPTH, BORDER, RESOLUTION, WIDTH, HEIGHT |
|
PNG |
PNG image |
ANTIALIAS, BIT_DEPTH, BORDER, TRANSPARENT, RESOLUTION, WIDTH, HEIGHT |
|
SVG |
Scalable Vector Graphics |
BITMAP, RESOLUTION, WIDTH, HEIGHT |
|
TIF, TIFF |
TIFF image |
ANTIALIAS, BIT_DEPTH, BORDER, CMYK, COMPRESSION, TRANSPARENT, RESOLUTION, WIDTH, HEIGHT |
Note: Support for SVG is highly dependent upon the vendor and version of your web browser. Certain features of SVG (such as text layout, linestyles, or colors) may look different in different web browsers, or may be rendered incorrectly. In this case, we recommend that you experiment with different web browsers.
Note: If the APPEND keyword was used in the previous call to the Save method, the Filename will be ignored.
Keywords
ANTIALIAS
By default, when doing output to bitmap file formats, if the output resolution is less than 300 dots-per-inch, then IDL will automatically use anti-aliasing to create a smoother-looking output image. Set this keyword to 0 to disable anti-aliasing. This keyword is ignored for vector file formats.
APPEND
Note: This keyword is valid only for GIF and PDF files.
Set this keyword to keep the file open after writing out the graphics. The next call to the Save method will then append the new graphics onto the same file, ignoring Filename. In the final call to Save you should specify both /APPEND and /CLOSE to ensure that the file is closed. See Additional Examples for a code sample that uses APPEND.
Note: When creating multi-image GIF files, the Save method with /APPEND may be called either from the same graphics object or different graphics objects. In either case, you should ensure that the image dimensions are the same for each call to the Save method.
Note: When creating multi-page PDF files, the Save method with /APPEND may be called either from the same graphics object or different graphics objects. In either case, a new page will be added to the PDF file for each call to the Save method.
BIT_DEPTH
Note: This keyword is valid only for PICT, PNG, and TIFF files.
Set this keyword to one of the following values:
|
0 |
Automatic (the default is 24-bit for all formats except PICT, which only supports 8-bit) |
|
1 |
8-bit (indexed color) |
|
2 |
24-bit |
BITMAP
Note: This keyword is valid only for EMF, EPS, PDF, and SVG files.
For EMF, EPS, PDF, and SVG files, the default behavior is to output 2D graphics (such as PLOTs and CONTOURs) in vector format, and 3D graphics in bitmap format. Set this keyword to 1 to force output in bitmap format, or to 0 to force output in vector format. Files in bitmap format will be larger but may give more accurate output (especially for transparency and 3D graphics). Files in vector format will be smaller and allow the resulting file to be edited in external programs.
BORDER
By default, the saved graphic includes all of the background regions around the graphic, out to the edge of the window. Set this keyword to an integer defining the width of the border around the graphic. For example, setting BORDER=0 will trim the graphic so that there are no extra border pixels surrounding the graphic. This keyword is ignored if the output is in vector format (BITMAP=0).
CENTIMETERS
Note: This keyword is valid only for PDF files.
Set this keyword to indicate that the PAGESIZE, WIDTH, HEIGHT, XMARGIN, and YMARGIN values are in centimeters. The default is inches.
CLOSE
Note: This keyword is valid only for GIF and PDF files.
After writing multiple images with the APPEND keyword, use this keyword on the final call to the Save method. For GIF files, CLOSE saves the data and properly closes the file. For PDF files, CLOSE clears the buffer.
See Additional Examples for a code sample that uses CLOSE.
CMYK
Note: This keyword is valid only for EPS and TIFF files.
Set this keyword to save the output image in CMYK format. The default format is RGB. This keyword is ignored if TRANSPARENT is set.
COMPRESSION
Note: This keyword is valid only for TIFF files.
Set this keyword to 0 for no compression (the default), to 1 for Pack bits compression, or to 2 for JPEG compression.
HEIGHT
For image or bitmap files, set this keyword to the height in pixels of the output image. If this keyword is set, the RESOLUTION keyword is ignored and the width is automatically calculated from the window's aspect ratio.
For EPS and PDF files, set this keyword to the height in inches (or centimeters if CENTIMETERS is set) of the graphics output. If this keyword is set, the width is automatically calculated from the window's aspect ratio.
LANDSCAPE
Note: This keyword is valid only for PDF files.
Set this keyword to indicate that the PDF output should be drawn in landscape orientation. The default is portrait orientation.
MEMORY
Note: This keyword is valid only for PDF files.
Set this keyword to prevent IDL from writing out intermediate results when using APPEND.
PAGE_SIZE
Note: This keyword is valid only for PDF files.
Set this keyword to a string or a two-element vector [width, height] giving the page size in inches (or centimeters if CENTIMETERS is set). The default value is [8.5, 11]. Allowed string values are "Letter", "Legal", "A4", and "A5".
RESOLUTION
Set this keyword to the output resolution (in dots per inch) to use when saving the window to an image or bitmap file format. If this keyword is not supplied, a default value of 600 DPI is used. The maximum output dimensions are 8192 x 8192. If the output dimensions are larger than these values, the resolution will be automatically reduced. This keyword is ignored if the output is in vector format (BITMAP=0).
REVERSIBLE
Note: This keyword is valid only for JPEG2000 files.
Set this keyword to use reversible (lossless) compression. The default behavior is to use irreversible (lossy) compression.
TRANSPARENT
Note: This keyword is valid only for PNG and TIFF files.
Set this keyword to an RGB value (a three-element vector of the form [R, G, B]) indicating which pixels in the output image should be made transparent. If this keyword is set to 1, the color of the lower left pixel in the image is used as the transparent color.
WIDTH
For image or bitmap files, set this keyword to the width in pixels of the output image. If this keyword is set, the RESOLUTION keyword is ignored and the height is automatically calculated from the window's aspect ratio.
For EPS and PDF files, set this keyword to the width in inches (or centimeters if CENTIMETERS is set) of the graphics output. If this keyword is set, the height is automatically calculated from the window's aspect ratio.
XMARGIN
Note: This keyword is valid only for PDF files.
Set this keyword to the x-offset from the lower-left corner of the page in inches (or centimeters if CENTIMETERS is set). The default behavior is to center the graphics on the page.
YMARGIN
Note: This keyword is valid only for PDF files.
Set this keyword to the y-offset from the lower-left corner of the page in inches (or centimeters if CENTIMETERS is set). The default behavior is to center the graphics on the page.
Additional Examples
The following example uses three plot graphics to create a multi-page PDF file. Each time we call the Save method we use the /APPEND keyword, and on the last call we add the /CLOSE keyword to clear out the PDF buffer.
PRO appendPDF_ex
; Create an array of graphic pointers
p = OBJARR(3)
; Create three plots with random data
FOR i = 0, 2 DO BEGIN
t = 0.1*FINDGEN(50)
y = SMOOTH(RANDOMU(seed,50), 5)
p[i] = PLOT(t,y,'b', SYMBOL='D', $
TITLE='Observation'+STRING(i+1))
ENDFOR
; Build the multi-page PDF file, one page at a time
p[0].Save, 'data1.pdf', /APPEND
p[1].Save, 'data1.pdf', /APPEND
p[2].Save, 'data1.pdf', /APPEND, /CLOSE
END
Version History
|
8.0 |
Introduced |
|
8.1 |
Added the following keywords: CLOSE, APPEND. KML/KMZ support was introduced. Multipage PDF support was introduced. |
|
8.2.3 |
Add support for SVG. |
|
8.4 |
Added ANTIALIAS keyword. |